<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Home In Manchester</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description_mc" content="">
<meta name="author" content="">

<!-- Le styles -->
<link href="assets/css/bootstrap.css" rel="stylesheet">
<link href="assets/css/bootstrap-responsive.css" rel="stylesheet">
<link href="assets/css/docs.css" rel="stylesheet">
<link href="assets/js/google-code-prettify/prettify.css"
	rel="stylesheet">

<!-- Le HTML5 shim, for IE6-8 support of HTML5 elements -->
<!--[if lt IE 9]>
      <script src="assets/js/html5shiv.js"></script>
    <![endif]-->

<style>
body {
	font-family: 微软雅黑;
	font-size: 14px;
}

.nav-list {
	margin-top: 0px;
}
h4{
	margin-top:25px;
}
</style>
</head>

<body data-spy="scroll" data-target=".bs-docs-sidebar">

	<!-- Navbar
    ================================================== -->
	<div class="navbar navbar-inverse navbar-fixed-top">
		<div class="navbar-inner">
			<div class="container">
				<button type="button" class="btn btn-navbar" data-toggle="collapse"
					data-target=".nav-collapse">
					<span class="icon-bar"></span> <span class="icon-bar"></span> <span
						class="icon-bar"></span>
				</button>
				<div class="nav-collapse collapse">
					<ul class="nav">
						<li class=""><a href="index.html">首页</a></li>
						<li class=""><a href="live.html">生活信息</a></li>
						<li class=""><a href="func.html">实用功能</a></li>
						<li class="active"><a href="forum.html">娱乐交友</a></li>
						<li class=""><a href="study.html">学术讨论</a></li>
						<li class=""><a href="member.html">会员管理</a></li>
						<li class=""><a href="bookFood.html">订餐系统</a></li>
						<li class=""><a href="ticket.html">票务系统</a></li>
						<li class=""><a href="coupon.html">优惠券</a></li>
						<li class=""><a href="readme.html">补充说明</a></li>
						<li class=""><a href="extend.html">扩展功能</a></li>
						<li class=""><a href="advert.html">广告</a></li>
						<li class=""><a href="report.html">公告系统</a></li>
						<li class=""><a href="radio.html">电台系统</a></li>
					</ul>
				</div>
			</div>
		</div>
	</div>

	<!-- Subhead
================================================== -->
	<header class="jumbotron subhead" id="overview">
		<div class="container">
			<h1>客户端接口调用指南</h1>
			<p class="lead">web客户端、移动客户端获取和设置服务器数据的统一接口访问规范。符合restful的api设计范式，提供跨平台的基于http协议的一致web接口。</p>
		</div>
	</header>


	<div class="container">

		<!-- Docs nav
    ================================================== -->
		<div class="row">
			<div class="span3 bs-docs-sidebar">
				
				<ul class="nav nav-list bs-docs-sidenav">
				<h3>论坛API</h3>
					<li><a href="#forums"><i class="icon-chevron-right"></i>
							获取全部论坛版块</a></li>
					<li><a href="#forum"><i class="icon-chevron-right"></i>
							获取某个论坛版块</a></li>
					<li><a href="#forum1"><i class="icon-chevron-right"></i>
							"约"功能</a></li>
					<li><a href="#topics"><i class="icon-chevron-right"></i>
							获取全部论坛主题</a></li>
					<li><a href="#topic_new"><i class="icon-chevron-right"></i>
							发表论坛主题</a></li>
					<li><a href="#posts"><i class="icon-chevron-right"></i>
							浏览主题帖子</a></li>
					<li><a href="#reply_topic"><i class="icon-chevron-right"></i>
							回复主题帖子</a></li>
					<li><a href="#post_new"><i class="icon-chevron-right"></i>
							回复普通帖子</a></li>
					<li><a href="#myTopic"><i class="icon-chevron-right"></i>
							获取发表的主题</a></li>
					<li><a href="#myReply"><i class="icon-chevron-right"></i>
							获取回复过的帖子</a></li>
			
					<h3>同城API</h3>
					<li><a href="#cities"><i class="icon-chevron-right"></i>
							获取全部城市列表</a></li>
					<li><a href="#hotCities"><i class="icon-chevron-right"></i>
							获取热门城市列表</a></li>
					<li><a href="#cityMembers"><i class="icon-chevron-right"></i>
							获取同城会员列表</a></li>
					<li><a href="#cityTopics"><i class="icon-chevron-right"></i>
							获取同城帖子列表</a></li>
					
				</ul>
			</div>
			<div class="span9">



				<!-- Typography
        ================================================== -->
				<section id="forums">
					<div class="page-header">
						<h1>获取全部论坛版块API</h1>
					</div>
					
					<h3>1 功能说明</h3>
					<p>获取论坛分区、论坛版块以及子版块。</p>
					
					<br></br>
					<h3>2 接口调用说明</h3>
					<h4>2.1 URL</h4>
					<p>正式环境：http://[域名]/api/forum/forums</p>
					<p>测试环境：http://115.29.250.136:8080/homeInManchester/api/forum/forums</p>
					<h4>2.2  返回格式</h4>
					<p>json</p>
					<h4>2.3 http请求方式</h4>
					<p>GET</p>
					<h4>2.4 参数说明</h4>
					<p>(1) 公共参数 。详情可以参考 <a href="index.html#public_args">公共参数说明</a></p>
					<p>(2) 私有参数。无。</p>
					<h4>2.5 请求示例</h4>
					<code>http://115.29.250.136:8080/homeInManchester/api/forum/forums</code>
					
					<h4>2.6 返回参数说明</h4>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>forumId</td>
								<td>Integer</td>
								<td>论坛版块唯一标识。</td>
							</tr>
							<tr>
								<td>type</td>
								<td>Integer</td>
								<td>分区还是版块（type=0为论坛分区，type=1为论坛版块。论坛分区下只能包含版块，版块下才能包含主题。）</td>
							</tr>
							<tr>
								<td>name</td>
								<td>String</td>
								<td>版块或者分区名称</td>
							</tr>
							<tr>
								<td>status</td>
								<td>Integer</td>
								<td>版块状态标识。（status=1 表示隐藏；status=1表示正常；status=2表示群组）</td>
							</tr>
							<tr>
								<td>displayOrder</td>
								<td>Integer</td>
								<td>显示顺序（排列序号）。</td>
							</tr>
							<tr>
								<td>parentId</td>
								<td>Integer</td>
								<td>上级版块标识。</td>
							</tr>
							<tr>
								<td>description_mc</td>
								<td>text</td>
								<td>论坛版块描述，版规。</td>
							</tr>
							<tr>
								<td>topics</td>
								<td>Integer</td>
								<td>总主题数</td>
							</tr>
							<tr>
								<td>posts</td>
								<td>Integer</td>
								<td>总发帖数</td>
							</tr>
							<tr>
								<td>todayPosts</td>
								<td>Integer</td>
								<td>今天的发帖数</td>
							</tr>
							<tr>
								<td>yesterdayPosts</td>
								<td>Integer</td>
								<td>昨天的发帖数</td>
							</tr>
							<tr>
								<td>lastPost</td>
								<td>String</td>
								<td>最后发表的简要摘录（最多只有110个字符。。。）</td>
							</tr>
							<tr>
								<td>lastPostAuthor</td>
								<td>String</td>
								<td>最后发表的作者</td>
							</tr>
							<tr>
								<td>lastPostTime</td>
								<td>String</td>
								<td>最后发表时间</td>
							</tr>
							<tr>
								<td>level</td>
								<td>Integer</td>
								<td>群组等级（这个会在学术讨论部分用到，在论坛这里用不到）</td>
							</tr>
							<tr>
								<td>forumImg</td>
								<td>String</td>
								<td>论坛版块图片（缩略图）</td>
							</tr>
							<tr>
								<td>memo</td>
								<td>String</td>
								<td>论坛简介</td>
							</tr>
							<tr>
								<td>moderators</td>
								<td>String[]</td>
								<td>论坛的版主，以字符串数组的形式显示。</td>
							</tr>
							<tr>
								<td>children</td>
								<td>List</td>
								<td>子版块。</td>
							</tr>
						</tbody>
					</table>
					
					<h4 >2.7 错误返回码说明</h4>
					<p>公共错误返回码：参考 ： <a href="index.html#public-code">公共返回码说明</a> 。 </p>
					<p>私有错误返回码：暂无。</p>
					
					<h4>2.8 正确返回示例：</h4>
						
						<pre>
[
    {
        "displayOrder": "1", 
        "yesterdayPosts": 0, 
        "todayPosts": 0, 
        "moderators": [
            "admin"
        ], 
        "memo": null, 
        "posts": 0, 
        "forumImg": "", 
        "forumId": 1, 
        "parentId": 0, 
        "topics": 0, 
        "lastPost": "", 
        "name": "树洞论坛1", 
        "type": 0, 
        "level": 1, 
        "description_mc": "", 
        "status": 0, 
        "children": [
            {
                "displayOrder": "1", 
                "yesterdayPosts": 0, 
                "todayPosts": 0, 
                "moderators": [
                    "hsmart", 
                    "test", 
                    "tet"
                ], 
                "memo": "2", 
                "posts": 0, 
                "forumImg": "", 
                "forumId": 5, 
                "parentId": 1, 
                "topics": 0, 
                "lastPost": "", 
                "name": "hhelo22", 
                "type": 1, 
                "level": 0, 
                "description_mc": "2", 
                "status": 1, 
                "children": [ ]
            }, 
            {
                "displayOrder": "11", 
                "yesterdayPosts": 0, 
                "todayPosts": 0, 
                "moderators": [ ], 
                "memo": "", 
                "posts": 0, 
                "forumImg": "", 
                "forumId": 6, 
                "parentId": 1, 
                "topics": 0, 
                "lastPost": "", 
                "name": "iiui", 
                "type": 1, 
                "level": 0, 
                "description_mc": "", 
                "status": 1, 
                "children": [ ]
            }
        ]
    }, 
    {
        "displayOrder": "2", 
        "yesterdayPosts": 0, 
        "todayPosts": 0, 
        "moderators": [
            "hsmart", 
            "test", 
            "tet"
        ], 
        "memo": "", 
        "posts": 0, 
        "forumImg": "", 
        "forumId": 2, 
        "parentId": 0, 
        "topics": 0, 
        "lastPost": "", 
        "name": "约", 
        "type": 1, 
        "level": 1, 
        "description_mc": "", 
        "status": 1, 
        "children": [ ]
    }, 
    {
        "displayOrder": "11", 
        "yesterdayPosts": 0, 
        "todayPosts": 0, 
        "moderators": [ ], 
        "memo": null, 
        "posts": 0, 
        "forumImg": "http://localhost:8080/homeInManchester/resources/fileupload/ec30ffe1-f38e-47ed-83d0-a460501b6761.jpg", 
        "forumId": 3, 
        "parentId": 0, 
        "topics": 0, 
        "lastPost": "", 
        "name": "崆峒派", 
        "type": 0, 
        "level": 0, 
        "description_mc": "山东省", 
        "status": 1, 
        "children": [ ]
    }
]

</pre>
					<h4>2.9 错误返回示例</h4>
					<pre>
{
	"code":1000,
	"msg":"网络错误，http请求异常。"
}
					</pre>
					
					
				</section>


<!-- Code
        ================================================== -->
				<section id="forum">
					<div class="page-header">
						<h1>获取某个论坛版块API</h1>
					</div>
					<h3>1 功能说明</h3>
					<p>获取某个论坛版块的基本信息。</p>
					
					<br></br>
					<h3>2 接口调用说明</h3>
					<h4>2.1 URL</h4>
					<p>正式环境：</p>
					<p>请求方式：<code>http://[域名]/api/forum/forum</code></p>
					
					<p>测试环境：将[域名]替换为：115.29.250.136:8080/homeInManchester</p>
					<h4>2.2  返回格式</h4>
					<p>json</p>
					<h4>2.3 http请求方式</h4>
					<p>GET</p>
					<h4>2.4 参数说明</h4>
					<p>(1) 公共参数 。详情可以参考 <a href="index.html#public_args">公共参数说明</a></p>
					<p>(2) 私有参数。</p>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">是否必填</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>forumId</td>
								<td>必填</td>
								<td>Integer</td>
								<td>论坛版块ID。</td>
							</tr>
						</tbody>
					</table>
					
					<h4>2.5 请求示例</h4>
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/forum?forumId=5</code></p>
					
					<h4>2.6 返回参数说明</h4>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>forumId</td>
								<td>Integer</td>
								<td>论坛版块唯一标识。</td>
							</tr>
							<tr>
								<td>type</td>
								<td>Integer</td>
								<td>分区还是版块（type=0为论坛分区，type=1为论坛版块。论坛分区下只能包含版块，版块下才能包含主题。）</td>
							</tr>
							<tr>
								<td>name</td>
								<td>String</td>
								<td>版块或者分区名称</td>
							</tr>
							<tr>
								<td>status</td>
								<td>Integer</td>
								<td>版块状态标识。（status=1 表示隐藏；status=1表示正常；status=2表示群组）</td>
							</tr>
							<tr>
								<td>displayOrder</td>
								<td>Integer</td>
								<td>显示顺序（排列序号）。</td>
							</tr>
							<tr>
								<td>parentId</td>
								<td>Integer</td>
								<td>上级版块标识。</td>
							</tr>
							<tr>
								<td>description_mc</td>
								<td>text</td>
								<td>论坛版块描述，版规。</td>
							</tr>
							<tr>
								<td>topics</td>
								<td>Integer</td>
								<td>总主题数</td>
							</tr>
							<tr>
								<td>posts</td>
								<td>Integer</td>
								<td>总发帖数</td>
							</tr>
							<tr>
								<td>todayPosts</td>
								<td>Integer</td>
								<td>今天的发帖数</td>
							</tr>
							<tr>
								<td>yesterdayPosts</td>
								<td>Integer</td>
								<td>昨天的发帖数</td>
							</tr>
							<tr>
								<td>lastPost</td>
								<td>String</td>
								<td>最后发表的简要摘录（最多只有110个字符。。。）</td>
							</tr>
							<tr>
								<td>lastPostAuthor</td>
								<td>String</td>
								<td>最后发表的作者</td>
							</tr>
							<tr>
								<td>lastPostTime</td>
								<td>String</td>
								<td>最后发表时间</td>
							</tr>
							<tr>
								<td>level</td>
								<td>Integer</td>
								<td>群组等级（这个会在学术讨论部分用到，在论坛这里用不到）</td>
							</tr>
							<tr>
								<td>forumImg</td>
								<td>String</td>
								<td>论坛版块图片（缩略图）</td>
							</tr>
							<tr>
								<td>memo</td>
								<td>String</td>
								<td>论坛简介</td>
							</tr>
							<tr>
								<td>moderators</td>
								<td>String[]</td>
								<td>论坛的版主，以字符串数组的形式显示。</td>
							</tr>
							<tr>
								<td>children</td>
								<td>List</td>
								<td>子版块。</td>
							</tr>
						</tbody>
					</table>
					
					<h4 >2.7 错误返回码说明</h4>
					<p>公共错误返回码：参考 ： <a href="index.html#public-code">公共返回码说明</a> 。 </p>
					<p>私有错误返回码：暂无。</p>
					
					<h4>2.8 正确返回示例：</h4>
						<code>http://115.29.250.136:8080/homeInManchester/api/forum/forum?forumId=5</code>
						<pre>
{
    "forumId": 5, 
    "parentId": 1, 
    "topics": 0, 
    "lastPost": "", 
    "lastPostTime": null, 
    "lastPostAuthor": null, 
    "moderators": null, 
    "todayPosts": 0, 
    "yesterdayPosts": 0, 
    "displayOrder": "1", 
    "memo": "2", 
    "posts": 0, 
    "forumImg": "", 
    "name": "hhelo22", 
    "type": 1, 
    "level": 0, 
    "description_mc": "2", 
    "status": 1, 
    "children": [ ]
}
						</pre>
					
					
					
						
					<h4>2.9 错误返回示例</h4>
					
					<code>http://localhost:8080/homeInManchester/api/forum/forum</code>
					<pre>
{
    "msg": "Required int parameter 'forumId' is not present", 
    "object": null, 
    "code": "1001"
}
					</pre>

				</section>
				
				<section id="forum1">
					<div class="page-header">
						<h1>获取全部约 API</h1>
					</div>
					<h3>1 功能说明</h3>
					<p>约功能板块，目前从论坛版块中分离出来，单独请求。</p>
					
					<br></br>
					<h3>2 接口调用说明</h3>
					<h4>2.1 URL</h4>
					<p>正式环境：</p>
					<p>请求方式：<code>http://[域名]/api/forum/appoints</code></p>
					
					<p>测试环境：将[域名]替换为：115.29.250.136:8080/homeInManchester</p>
					<h4>2.2  返回格式</h4>
					<p>json</p>
					<h4>2.3 http请求方式</h4>
					<p>GET</p>
					<h4>2.4 参数说明</h4>
					<p>(1) 公共参数 。详情可以参考 <a href="index.html#public_args">公共参数说明</a></p>
					<p>(2) 私有参数。</p>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">是否必填</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>type</td>
								<td>必填</td>
								<td>Integer</td>
								<td>排序方式，默认为0。</td>
							</tr>
						</tbody>
					</table>
					
					<h4>2.5 请求示例</h4>
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/appoints?type=0</code></p>
					
					<h4>2.6 返回参数说明</h4>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>topicId</td>
								<td>Integer</td>
								<td>约ID</td>
							</tr>
							<tr>
								<td>forumId</td>
								<td>Integer</td>
								<td>所属论坛版块标识。此处固定值。</td>
							</tr>
							<tr>
								<td>subject</td>
								<td>String</td>
								<td>约标题。</td>
							</tr>
							<tr>
								<td>postDate</td>
								<td>Long</td>
								<td>约主题发表时间，该数据为时间的秒数，可以自由转化成各种格式化字符串显示。</td>
							</tr>
							<tr>
								<td>author</td>
								<td>String</td>
								<td>作者。后台发表的为admin</td>
							</tr>
							<tr>
								<td>authorId</td>
								<td>Long</td>
								<td>作者标识ID，后台发表的为0</td>
							</tr>
							<tr>
								<td>userIp</td>
								<td>String</td>
								<td>用户IP</td>
							</tr>
							<tr>
								<td>members</td>
								<td>Integer</td>
								<td>约人数。</td>
							</tr>
							<tr>
								<td>appointTime</td>
								<td>String</td>
								<td>约时间</td>
							</tr>
							<tr>
								<td>lastPoster</td>
								<td>String</td>
								<td>最后回复用户</td>
							</tr>
							<tr>
								<td>lastPostDate</td>
								<td>Long</td>
								<td>最后回复日期</td>
							</tr>
							
							<tr>
								<td>appointDemand</td>
								<td>String</td>
								<td>约要求</td>
							</tr>
							<tr>
								<td>joinType</td>
								<td>Integer</td>
								<td>约加入方式：0 公开；1 邀请；2 审核</td>
							</tr>
							<tr>
								<td>viewPerm</td>
								<td>Integer</td>
								<td>浏览权限：1 仅成员；0 所有用户</td>
							</tr>
							<tr>
								<td>colosed</td>
								<td>Integer</td>
								<td>是否关闭，1标识是，0标识否，默认为否。</td>
							</tr>
							<tr>
								<td>linkMan</td>
								<td>String</td>
								<td>联系人。</td>
							</tr>
							<tr>
								<td>linkPhone</td>
								<td>String</td>
								<td>联系方式。</td>
							</tr>
							<tr>
								<td>message</td>
								<td>Text</td>
								<td>约内容。</td>
							</tr>
							<tr>
								<td>inviteUsers</td>
								<td>String</td>
								<td>如果是邀请加入方式，此处为邀请的好友账号，中间用逗号隔开，如user1,user2。</td>
							</tr>
							<tr>
								<td>appointType</td>
								<td>Integer</td>
								<td>约类型。</td>
							</tr>
						</tbody>
					</table>
					
					<h4 >2.7 错误返回码说明</h4>
					<p>公共错误返回码：参考 ： <a href="index.html#public-code">公共返回码说明</a> 。 </p>
					<p>私有错误返回码：暂无。</p>
					
					<h4>2.8 正确返回示例：</h4>
						<code>http://115.29.250.136:8080/homeInManchester/api/forum/appoints?type=0</code>
						<pre>
{
    "result": [
        {
            "header": null, 
            "joinType": 0, 
            "viewPerm": 0, 
            "replies": 0, 
            "menuName": null, 
            "closed": 0, 
            "lastPoster": "admin", 
            "highLight": 0, 
            "colosed": 0, 
            "linkMan": "马广洋", 
            "linkPhone": "23123213", 
            "sortId": 0, 
            "advertStr": null, 
            "advert": {
                "adId": 0, 
                "adPos": 0, 
                "adType": 0, 
                "adDesc": null, 
                "adContent": null, 
                "moduleType": 0, 
                "moduleId": 0, 
                "type": 0, 
                "status": 0
            }, 
            "forumId": 2, 
            "postDate": 1428739084, 
            "author": "admin", 
            "subject": "一起打星际", 
            "authorId": 0, 
            "userIp": null, 
            "topicId": 39, 
            "lastPost": 1428739121, 
            "views": 0, 
            "displayOrder": 0, 
            "appointDemand": "自带鼠标哦", 
            "appointTime": "2015年4月22日", 
            "appointType": 100, 
            "lastPostDate": null, 
            "inviteUsers": "", 
            "name": null, 
            "message": "放假了，轻松一下。xx网吧，二楼，不见不散！", 
            "type": 0, 
            "members": 4, 
            "images": "59df8e12-9dcb-4ec8-995d-b08396dab2fc.jpg,1f91e6d2-32d5-4bbc-a34e-d91174107e68.jpg", 
            "digest": 0
        }, 
        {
            "header": null, 
            "joinType": 0, 
            "viewPerm": 0, 
            "replies": 0, 
            "menuName": null, 
            "closed": 0, 
            "lastPoster": "admintest", 
            "highLight": 0, 
            "colosed": 0, 
            "linkMan": "马广洋", 
            "linkPhone": "123132131", 
            "sortId": 0, 
            "advertStr": null, 
            "advert": {
                "adId": 0, 
                "adPos": 0, 
                "adType": 0, 
                "adDesc": null, 
                "adContent": null, 
                "moduleType": 0, 
                "moduleId": 0, 
                "type": 0, 
                "status": 0
            }, 
            "forumId": 2, 
            "postDate": 1389520028, 
            "author": "admintest", 
            "subject": "郊游去。。。。", 
            "authorId": 60, 
            "userIp": "111.126.197.2", 
            "topicId": 15, 
            "lastPost": 1428737418, 
            "views": 0, 
            "displayOrder": 0, 
            "appointDemand": "着夏装，清凉服饰，自带水、食物。", 
            "appointTime": "2015年4月12日", 
            "appointType": 98, 
            "lastPostDate": null, 
            "inviteUsers": "", 
            "name": null, 
            "message": "<div style=\"text-align: left;\"><table cellspacing=\"0\" cellpadding=\"0\" style=\"word-wrap: break-word; empty-cells: show; border-collapse: collapse; table-layout: fixed; width: 757px; color: rgb(68, 68, 68); font-family: Tahoma, 'Microsoft Yahei', Simsun; line-height: 18px;\"><tbody style=\"word-wrap: break-word;\"><tr style=\"word-wrap: break-word;\"><td class=\"t_f\" id=\"postmessage_31856016\" style=\"word-wrap: break-word; font-size: 16px;\">3月的季节，乍暖还寒~冬天再寒冷也挡不住春天的脚步，你看那枝头，已经在孕育着杨花柳絮了，你仔细看看，已经有了那萌芽的绿色，那是春天的颜色，啊~~真辛福！春天来了~~那我就来件和这情景相称的外套吧，穿上它去踏青咯~用线：</td></tr></tbody></table><br /></div>", 
            "type": 0, 
            "members": 5, 
            "images": "00f53d9e-bc7c-4699-b01c-c73f5ddf7cf7.jpg,548de995-037c-4b5b-a411-bf4a105c7a9f.jpg", 
            "digest": 0
        }
    ], 
    "pageNum": 1, 
    "numPerPage": 8, 
    "totalPage": 1, 
    "totalCount": 2
}
						</pre>
					
					
					
						
					<h4>2.9 错误返回示例</h4>
					
					<code>http://localhost:8080/homeInManchester/api/forum/forum</code>
					<pre>
{
    "msg": "Required int parameter 'forumId' is not present", 
    "object": null, 
    "code": "1001"
}
					</pre>

				</section>

				<!-- Code
        ================================================== -->
				<section id="topics">
					<div class="page-header">
						<h1>获取全部论坛主题API</h1>
					</div>
					<h3>1 功能说明</h3>
					<p>获取各个论坛版块下的主题列表</p>
					
					<br></br>
					<h3>2 接口调用说明</h3>
					<h4>2.1 URL</h4>
					<p>正式环境：</p>
					<p>1）默认请求方式：<code>http://[域名]/api/forum/topics</code></p>
					<p>2）设置请求页码数：<code>http://[域名]/api/forum/topics/{pageNum}</code></p>
					<p>3）设置请求页码数，设置每页多少条：<code>http://[域名]/api/forum/topics/{pageNum}/{numPerPage}</code></p>
					
					<p>测试环境：将[域名]替换为：115.29.250.136:8080/homeInManchester</p>
					<h4>2.2  返回格式</h4>
					<p>json</p>
					<h4>2.3 http请求方式</h4>
					<p>GET</p>
					<h4>2.4 参数说明</h4>
					<p>(1) 公共参数 。详情可以参考 <a href="index.html#public_args">公共参数说明</a></p>
					<p>(2) 私有参数。</p>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">是否必填</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>forumId</td>
								<td>必填</td>
								<td>Integer</td>
								<td>所属论坛版块ID。</td>
							</tr>
							<tr>
								<td>type</td>
								<td>必填</td>
								<td>Integer</td>
								<td>主题列表显示规则。默认提供4种：type=0表示最新发表，type=1表示最新回复；type=2表示精华帖子；type=3表示排行（置顶帖子）。</td>
							</tr>
							<tr style="color:red">
								<td>forumType</td>
								<td>选填</td>
								<td>Integer</td>
								<td>0标识论坛，1标识学习小组。这里是针对学习小组部分添加的更新，并不影响原来论坛的使用，但是要查询学习小组的话题列表，则需要此处为必填，且值为1。</td>
							</tr>
						</tbody>
					</table>
					
					<h4>2.5 请求示例</h4>
					<p>第一种：默认分页方式（服务器提供默认的当前页码和一页多少条数据，默认第1页，每页8条）</p>
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/topics?forumId=2&type=0</code></p>
					<p>第二种：只提供第几页（默认一页8条仍由服务器指定）</p>
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/topics/2?forumId=2&type=0</code></p>
					<p>第三种：指定分页，自定义一页显示条数.（显示第2页，每页显示20条）</p>
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/topics/2/20?forumId=2&type=0</code></p>
					
					<h4>2.6 返回参数说明</h4>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>numPerPage</td>
								<td>Integer</td>
								<td>每页显示条数。</td>
							</tr>
							<tr>
								<td>pageNum</td>
								<td>Integer</td>
								<td>当前第几页。</td>
							</tr>
							<tr>
								<td>totalCount</td>
								<td>Integer</td>
								<td>总的主题数。</td>
							</tr>
							<tr>
								<td>totalPage</td>
								<td>Integer</td>
								<td>总页数。</td>
							</tr>
							<tr>
								<td>result</td>
								<td>Object[]</td>
								<td>主题列表集合，具体返回参数说明参考下面<a href="#result">《result的具体返回参数说明》</a></td>
							</tr>
						</tbody>
					</table>
					<p id="result"><strong>result的具体返回参数说明</strong></p>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>topicId</td>
								<td>Integer</td>
								<td>主题标识ID</td>
							</tr>
							<tr>
								<td>forumId</td>
								<td>Integer</td>
								<td>所属论坛版块标识。</td>
							</tr>
							<tr>
								<td>subject</td>
								<td>String</td>
								<td>标题。</td>
							</tr>
							<tr>
								<td>postDate</td>
								<td>Long</td>
								<td>主题发表时间，该数据为时间的秒数，可以自由转化成各种格式化字符串显示。</td>
							</tr>
							<tr>
								<td>author</td>
								<td>String</td>
								<td>作者。</td>
							</tr>
							<tr>
								<td>authorId</td>
								<td>Long</td>
								<td>作者标识ID</td>
							</tr>
							<tr>
								<td>userIp</td>
								<td>String</td>
								<td>用户IP</td>
							</tr>
							<tr>
								<td>lastPost</td>
								<td>Long</td>
								<td>该主题的最后回复时间，该数据为时间的秒数，可以自由转化成各种格式化字符串显示。</td>
							</tr>
							<tr>
								<td>displayOrder</td>
								<td>Integer</td>
								<td>显示顺序（置顶）。系统提供三级置顶分别为3、2、1、0。0为正常帖子。1、2、3分别代表1级置顶、2级置顶、3级置顶。</td>
							</tr>
							<tr>
								<td>lastPoster</td>
								<td>String</td>
								<td>最后回复用户</td>
							</tr>
							<tr>
								<td>lastPostDate</td>
								<td>Long</td>
								<td>最后回复日期</td>
							</tr>
							
							<tr>
								<td>views</td>
								<td>Long</td>
								<td>浏览数</td>
							</tr>
							<tr>
								<td>replies</td>
								<td>Long</td>
								<td>回复数</td>
							</tr>
							<tr>
								<td>highLight</td>
								<td>Integer</td>
								<td>是否高亮显示，1标识是，0标识否，默认为否。</td>
							</tr>
							<tr>
								<td>colosed</td>
								<td>Integer</td>
								<td>是否关闭，1标识是，0标识否，默认为否。</td>
							</tr>
							<tr>
								<td>name</td>
								<td>String</td>
								<td>标题。</td>
							</tr>
							<tr>
								<td>message</td>
								<td>Text</td>
								<td>内容。</td>
							</tr>
							<tr>
								<td>digest</td>
								<td>Integer</td>
								<td>精华设置。系统提供三级精华分别为3、2、1、0。0为正常帖子。1、2、3分别代表1级精华、2级精华、3级精华。</td>
							</tr>
						</tbody>
					</table>
					
					<h4 >2.7 错误返回码说明</h4>
					<p>公共错误返回码：参考 ： <a href="index.html#public-code">公共返回码说明</a> 。 </p>
					<p>私有错误返回码：暂无。</p>
					
					<h4>2.8 正确返回示例：</h4>
						<code>http://115.29.250.136:8080/homeInManchester/api/forum/topics/1/10?forumId=2&type=0</code>
						<pre>
{
    "result": [
        {
            "forumId": 2, 
            "subject": "野外郊游", 
            "postDate": 1387612883, 
            "author": "test", 
            "authorId": 19, 
            "userIp": "0:0:0:0:0:0:0:1", 
            "lastPost": 1387612883, 
            "topicId": 11, 
            "views": 0, 
            "replies": 0, 
            "highLight": 0, 
            "colosed": 0, 
            "displayOrder": 0, 
            "lastPoster": "test", 
            "lastPostDate": null, 
            "name": null, 
            "message": "规范和返回", 
            "digest": 1
        }, 
        {
            "forumId": 2, 
            "subject": "去图书馆了", 
            "postDate": 1387612828, 
            "author": "test", 
            "authorId": 19, 
            "userIp": "0:0:0:0:0:0:0:1", 
            "lastPost": 1387612828, 
            "topicId": 10, 
            "views": 0, 
            "replies": 0, 
            "highLight": 0, 
            "colosed": 0, 
            "displayOrder": 3, 
            "lastPoster": "test", 
            "lastPostDate": null, 
            "name": null, 
            "message": "规范和返回", 
            "digest": 1
        }, 
        {
            "forumId": 2, 
            "subject": "约 游泳", 
            "postDate": 1387612821, 
            "author": "test", 
            "authorId": 19, 
            "userIp": "0:0:0:0:0:0:0:1", 
            "lastPost": 1387612821, 
            "topicId": 9, 
            "views": 0, 
            "replies": 0, 
            "highLight": 0, 
            "colosed": 0, 
            "displayOrder": 0, 
            "lastPoster": "test", 
            "lastPostDate": null, 
            "name": null, 
            "message": "规范和返回", 
            "digest": 1
        }, 
        {
            "forumId": 2, 
            "subject": "约 “去图书馆”", 
            "postDate": 1387612801, 
            "author": "test", 
            "authorId": 19, 
            "userIp": "0:0:0:0:0:0:0:1", 
            "lastPost": 1387612801, 
            "topicId": 8, 
            "views": 0, 
            "replies": 0, 
            "highLight": 0, 
            "colosed": 0, 
            "displayOrder": 0, 
            "lastPoster": "test", 
            "lastPostDate": null, 
            "name": null, 
            "message": "规范和返回", 
            "digest": 0
        }
    ], 
    "numPerPage": 10, 
    "pageNum": 1, 
    "totalPage": 1, 
    "totalCount": 4
}
						</pre>
					
					
					
						
					<h4>2.9 错误返回示例</h4>
					
					<code>http://localhost:8080/homeInManchester/api/forum/topics/1/10?forumId=1</code>
					<pre>
{
    "msg": "Required int parameter 'type' is not present", 
    "object": null, 
    "code": "1001"
}
					</pre>

				</section>


				<section id="topic_new">
					<div class="page-header">
						<h1>发表论坛主题API</h1>
					</div>
					<h3>1 功能说明</h3>
					<p>在指定的版块内发表相应的主题帖子。</p>
					
					<br></br>
					<h3>2 接口调用说明</h3>
					<h4>2.1 URL</h4>
					<p>正式环境：</p>
					<p><code>http://[域名]/api/forum/topic</code></p>
					
					<p>测试环境：将[域名]替换为：115.29.250.136:8080/homeInManchester</p>
					
					<h4>2.2  返回格式</h4>
					<p>json</p>
					<h4>2.3 http请求方式</h4>
					<p>POST</p>
					<h4>2.4 参数说明</h4>
					<p>(1) 公共参数 。详情可以参考 <a href="index.html#public_args">公共参数说明</a></p>
					<p>(2) 私有参数。</p>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">是否必填</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>forumId</td>
								<td>必填</td>
								<td>Integer</td>
								<td>所属论坛版块ID。</td>
							</tr>
							<tr>
								<td>subject</td>
								<td>必填</td>
								<td>String</td>
								<td>标题。</td>
							</tr>
							<tr>
								<td>message</td>
								<td>必填</td>
								<td>String</td>
								<td>内容。</td>
							</tr>
							<tr style="color:red">
								<td>type</td>
								<td>选填</td>
								<td>Integer</td>
								<td>0标识论坛主题；1标识为学习小组话题。此处为新增内容，针对学习小组而设。默认为论坛主题，只有设置type=1时，才为学习小组话题。</td>
							</tr>
							<tr style="color:red">
								<td>images</td>
								<td>选填</td>
								<td>String</td>
								<td>图片地址。支持上传多个，这里是多个图片上传成功后的文件名+后缀名。多个的话，请用英文“,”隔开，如：“ba9538fa-5270-44dc-aafb-586c4d993c7e.jpg,ff4463a5-0758-459c-9bbf-200a8273150b.jpg”。上传并获取图片地址，请参考 <a href="func.html#post_image">上传图片API</a>。</td>
							</tr>
						</tbody>
					</table>
					
					<h4>2.5 请求示例</h4>
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/topic</code></p>
					
					<h4>2.6 返回参数说明</h4>
					<p>请求正确的话，会成功返回true。不正确的话，会返回错误码，见2.7说明。</p>
					
					<h4 >2.7 错误返回码说明</h4>
					<p>公共错误返回码：参考 ： <a href="index.html#public-code">公共返回码说明</a> 。 </p>
					<p>私有错误返回码：</p>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">返回码（code）</th>
								<th width="100">返回信息(msg)</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>2000</td>
								<td>会员未登录，不允许发表主题！</td>
								<td>用来判断会员是否登录。</td>
							</tr>
							<tr>
								<td>3104</td>
								<td>所属论坛版块ID为空！</td>
								<td>必填项：forumId缺失</td>
							</tr>
							<tr>
								<td>3102</td>
								<td>主题标题为空！</td>
								<td>必填项：subject缺失</td>
							</tr>
							<tr>
								<td>3103</td>
								<td>主题内容为空！</td>
								<td>必填项：message缺失</td>
							</tr>
						</tbody>
					</table>
					
					<h4>2.8 正确返回示例：</h4>
						<p>注意：请在提交前务必进行基本数据校验，如：forumId不能为空，forumId必须为整数等。</p>
						<code>http://115.29.250.136:8080/homeInManchester/api/forum/topic</code>
						<pre>
true
						</pre>
					
					
					<h4>2.9 错误返回示例</h4>
					
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/topic</code></p>
1）、
					<pre>
{"msg":"会员未登录，不允许发表主题！","object":null,"code":"2000"}				
				</pre>
2）、
<pre>
{"msg":"主题标题为空！","object":null,"code":"3102"}
</pre>
3)、
<pre>
{"msg":"主题内容为空！","object":null,"code":"3103"}
</pre>
<p>说明：第一种错误可以进行判断，要求用户进行登录，否则不允许发表主题。第二、三种错误则需要客户端做验证，避免出现。</p>
				</section>
				
				
				<section id="posts">
					<div class="page-header">
						<h1>浏览主题帖子API</h1>
					</div>
					
					<h3>1 功能说明</h3>
					<p>浏览主题帖，显示回复列表。</p>
					
					<br></br>
					<h3>2 接口调用说明</h3>
					<h4>2.1 URL</h4>
					<p>正式环境：</p>
					<p><code>http://[域名]/api/forum/topic/{topicId}</code></p>
					<p>测试环境：</p>
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/topic/{topicId}</code></p>
					<h4>2.2  返回格式</h4>
					<p>json</p>
					<h4>2.3 http请求方式</h4>
					<p>GET</p>
					<h4>2.4 参数说明</h4>
					<p>(1) 公共参数 。详情可以参考 <a href="index.html#public_args">公共参数说明</a></p>
					<p>(2) 私有参数。无。</p>
					<h4>2.5 请求示例</h4>
					<p>浏览主题Id为9的帖子内容及全部回帖列表</p>
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/topic/9</code></p>
					
					<h4>2.6 返回参数说明</h4>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>anonymous</td>
								<td>Integer</td>
								<td>是否匿名发表。1标识匿名发表，0标识非匿名。</td>
							</tr>
							<tr>
								<td>forumId</td>
								<td>Integer</td>
								<td>所属论坛版块ID</td>
							</tr>
							<tr>
								<td>subject</td>
								<td>String</td>
								<td>标题。一般属于楼主标题，也就是主题帖，会有标题，其他回复贴均没有标题。</td>
							</tr>
							<tr>
								<td>postDate</td>
								<td>Long</td>
								<td>发表日期。返回值为时间秒数。</td>
							</tr>
							<tr>
								<td>author</td>
								<td>String</td>
								<td>作者用户名。如果是匿名发表的话，就直接显示”匿名“</td>
							</tr>
							<tr>
								<td>authorId</td>
								<td>Integer</td>
								<td>用户ID。如果是匿名发表，则为0</td>
							</tr>
							<tr>
								<td>topicId</td>
								<td>Long</td>
								<td>主题ID。</td>
							</tr>
							<tr>
								<td>postId</td>
								<td>Long</td>
								<td>回帖ID</td>
							</tr>
							<tr>
								<td>postIp</td>
								<td>String</td>
								<td>回帖客户端ip地址</td>
							</tr>
							<tr>
								<td>invisible</td>
								<td>Integer</td>
								<td>不可见。默认为0（可见）</td>
							</tr>
							<tr>
								<td>message</td>
								<td>String</td>
								<td>回复内容。</td>
							</tr>
							<tr>
								<td>first</td>
								<td>Integer</td>
								<td>是否楼主（主题帖），1为主题帖，0为普通回帖</td>
							</tr>
							<tr style="color:red">
								<td>images</td>
								<td>String</td>
								<td>图片路径。此处显示为多个1f91e6d2-32d5-4bbc-a34e-d91174107e68.jpg，如果是多个图片，中间用逗号隔开：59df8e12-9dcb-4ec8-995d-b08396dab2fc.jpg,1f91e6d2-32d5-4bbc-a34e-d91174107e68.jpg。图片实际路径为：http://115.29.250.136:8080/homeInManchester/resources/fileupload/1f91e6d2-32d5-4bbc-a34e-d91174107e68.jpg</td>
							</tr>
							
						</tbody>
					</table>
					
					<h4 >2.7 错误返回码说明</h4>
					<p>公共错误返回码：参考 ： <a href="index.html#public-code">公共返回码说明</a> 。 </p>
					<p>私有错误返回码：暂无。</p>
					
					<h4>2.8 正确返回示例：</h4>
						
						<pre>
[
    {
        "anonymous": 0, 
        "forumId": 2, 
        "subject": "约 游泳", 
        "postDate": 1387612821, 
        "author": "test", 
        "authorId": 19, 
        "topicId": 9, 
        "postId": 6, 
        "postIp": "0:0:0:0:0:0:0:1", 
        "invisible": 0, 
        "message": "规范和返回", 
        "first": 1
    }, 
    {
        "anonymous": 0, 
        "forumId": 2, 
        "subject": null, 
        "postDate": 1387855168, 
        "author": "匿名", 
        "authorId": 0, 
        "topicId": 9, 
        "postId": 11, 
        "postIp": "0:0:0:0:0:0:0:1", 
        "invisible": 0, 
        "message": "sds是", 
        "first": 0
    }, 
    {
        "anonymous": 0, 
        "forumId": 2, 
        "subject": null, 
        "postDate": 1387854251, 
        "author": "hsmart", 
        "authorId": 21, 
        "topicId": 9, 
        "postId": 10, 
        "postIp": "0:0:0:0:0:0:0:1", 
        "invisible": 0, 
        "message": "同去同去", 
        "first": 0
    }
]
</pre>
					<h4>2.9 错误返回示例</h4>
					<pre>
暂无
					</pre>
					
					
				</section>
				
				<section id="reply_topic">
					<div class="page-header">
						<h1>回复主题帖子API</h1>
					</div>
					<h3>1 功能说明</h3>
					<p>论坛回帖。</p>
					<div class='text-center'><img src='../img/reply_topic.png' style="border:1px solid #dddddd;"></div>
					<br></br>
					<h3>2 接口调用说明</h3>
					<h4>2.1 URL</h4>
					<p>正式环境：</p>
					<p><code>http://[域名]/api/forum/post</code></p>
					
					<p>测试环境：将[域名]替换为：115.29.250.136:8080/homeInManchester</p>
					
					<h4>2.2  返回格式</h4>
					<p>json</p>
					<h4>2.3 http请求方式</h4>
					<p>POST</p>
					<h4>2.4 参数说明</h4>
					<p>(1) 公共参数 。详情可以参考 <a href="index.html#public_args">公共参数说明</a></p>
					<p>(2) 私有参数。</p>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">是否必填</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>forumId</td>
								<td>必填</td>
								<td>Integer</td>
								<td>所属论坛版块ID。</td>
							</tr>
							<tr>
								<td>topicId</td>
								<td>必填</td>
								<td>Integer</td>
								<td>要回复的主题ID。</td>
							</tr>
							<tr>
								<td>anonymous</td>
								<td>必填</td>
								<td>Integer</td>
								<td>是否匿名。</td>
							</tr>
							<tr>
								<td>message</td>
								<td>必填</td>
								<td>String</td>
								<td>回复内容。</td>
							</tr>
						</tbody>
					</table>
					
					<h4>2.5 请求示例</h4>
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/post</code></p>
					
					<h4>2.6 返回参数说明</h4>
					<p>请求正确的话，会成功返回true。不正确的话，会返回错误码，见2.7说明。</p>
					
					<h4 >2.7 错误返回码说明</h4>
					<p>公共错误返回码：参考 ： <a href="index.html#public-code">公共返回码说明</a> 。 </p>
					<p>私有错误返回码：</p>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">返回码（code）</th>
								<th width="100">返回信息(msg)</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>2000</td>
								<td>会员未登录，不允许回复主题！</td>
								<td>用来判断会员是否登录。</td>
							</tr>
							<tr>
								<td>3201</td>
								<td>回复内容为空！</td>
								<td>必填项：message缺失</td>
							</tr>
						</tbody>
					</table>
					
					<h4>2.8 正确返回示例：</h4>
						<p>注意：请在提交前务必进行基本数据校验，如：forumId不能为空，forumId必须为整数等。</p>
						<code>http://115.29.250.136:8080/homeInManchester/api/forum/post</code>
						<pre>
true
						</pre>
					
					
					<h4>2.9 错误返回示例</h4>
					
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/post</code></p>
1）、
					<pre>
{"msg":"会员未登录，不允许发表回复！","object":null,"code":"2000"}				
				</pre>
2）、
<pre>
{"msg":"回复内容为空！","object":null,"code":"3201"}
</pre>

<p>说明：第一种错误可以进行判断，要求用户进行登录，否则不允许发表主题。其他错误则需要客户端做验证，避免出现。</p>
				</section>
				
				
				<section id="post_new">
					<div class="page-header">
						<h1>回复普通帖子API</h1>
					</div>
					<h3>1 功能说明</h3>
					<p>功能完全同<a href="forum.html#reply_topic">《回复主题帖子》</a>部分。唯一不同的地方是，回复的时候需要引用原回复内容，如下图所示：</p>
					
					<div class="text-center thumbnails">
						<img src='../img/reply.png' style="border:1px solid #dddddd;">
					</div>
				</section>
				
				
				<section id="myTopic">
					<div class="page-header">
						<h1>获取用户发表过的主题API</h1>
					</div>
					<h3>1 功能说明</h3>
					<p>获取当前用户发表过的主题列表。</p>
					
					<br></br>
					<h3>2 接口调用说明</h3>
					<h4>2.1 URL</h4>
					<p>正式环境：</p>
					<p>1）默认请求方式：<code>http://[域名]/api/forum/mytopics</code></p>
					<p>2）设置请求页码数：<code>http://[域名]/api/forum/mytopics/{pageNum}</code></p>
					<p>3）设置请求页码数，设置每页多少条：<code>http://[域名]/api/forum/mytopics/{pageNum}/{numPerPage}</code></p>
					
					<p>测试环境：将[域名]替换为：115.29.250.136:8080/homeInManchester</p>
					<h4>2.2  返回格式</h4>
					<p>json</p>
					<h4>2.3 http请求方式</h4>
					<p>GET</p>
					<h4>2.4 参数说明</h4>
					<p>(1) 公共参数 。详情可以参考 <a href="index.html#public_args">公共参数说明</a></p>
					<p>(2) 私有参数。暂无。</p>
					
					<h4>2.5 请求示例</h4>
					<p>第一种：默认分页方式（服务器提供默认的当前页码和一页多少条数据，默认第1页，每页8条）</p>
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/mytopics</code></p>
					<p>第二种：只提供第几页（默认一页8条仍由服务器指定）</p>
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/mytopics/2</code></p>
					<p>第三种：指定分页，自定义一页显示条数.（显示第2页，每页显示20条）</p>
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/mytopics/2/20</code></p>
					
					<h4>2.6 返回参数说明</h4>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>numPerPage</td>
								<td>Integer</td>
								<td>每页显示条数。</td>
							</tr>
							<tr>
								<td>pageNum</td>
								<td>Integer</td>
								<td>当前第几页。</td>
							</tr>
							<tr>
								<td>totalCount</td>
								<td>Integer</td>
								<td>总的主题数。</td>
							</tr>
							<tr>
								<td>totalPage</td>
								<td>Integer</td>
								<td>总页数。</td>
							</tr>
							<tr>
								<td>result</td>
								<td>Object[]</td>
								<td>主题列表集合，具体返回参数说明参考下面<a href="#result">《result的具体返回参数说明》</a></td>
							</tr>
						</tbody>
					</table>
					<p id="result"><strong>result的具体返回参数说明</strong></p>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>topicId</td>
								<td>Integer</td>
								<td>主题标识ID</td>
							</tr>
							<tr>
								<td>forumId</td>
								<td>Integer</td>
								<td>所属论坛版块标识。</td>
							</tr>
							<tr>
								<td>subject</td>
								<td>String</td>
								<td>标题。</td>
							</tr>
							<tr>
								<td>postDate</td>
								<td>Long</td>
								<td>主题发表时间，该数据为时间的秒数，可以自由转化成各种格式化字符串显示。</td>
							</tr>
							<tr>
								<td>author</td>
								<td>String</td>
								<td>作者。</td>
							</tr>
							<tr>
								<td>authorId</td>
								<td>Long</td>
								<td>作者标识ID</td>
							</tr>
							<tr>
								<td>userIp</td>
								<td>String</td>
								<td>用户IP</td>
							</tr>
							<tr>
								<td>lastPost</td>
								<td>Long</td>
								<td>该主题的最后回复时间，该数据为时间的秒数，可以自由转化成各种格式化字符串显示。</td>
							</tr>
							<tr>
								<td>displayOrder</td>
								<td>Integer</td>
								<td>显示顺序（置顶）。系统提供三级置顶分别为3、2、1、0。0为正常帖子。1、2、3分别代表1级置顶、2级置顶、3级置顶。</td>
							</tr>
							<tr>
								<td>lastPoster</td>
								<td>String</td>
								<td>最后回复用户</td>
							</tr>
							<tr>
								<td>lastPostDate</td>
								<td>Long</td>
								<td>最后回复日期</td>
							</tr>
							
							<tr>
								<td>views</td>
								<td>Long</td>
								<td>浏览数</td>
							</tr>
							<tr>
								<td>replies</td>
								<td>Long</td>
								<td>回复数</td>
							</tr>
							<tr>
								<td>highLight</td>
								<td>Integer</td>
								<td>是否高亮显示，1标识是，0标识否，默认为否。</td>
							</tr>
							<tr>
								<td>colosed</td>
								<td>Integer</td>
								<td>是否关闭，1标识是，0标识否，默认为否。</td>
							</tr>
							<tr>
								<td>name</td>
								<td>String</td>
								<td>论坛版块。</td>
							</tr>
							<tr>
								<td>message</td>
								<td>Text</td>
								<td>内容。</td>
							</tr>
							<tr>
								<td>digest</td>
								<td>Integer</td>
								<td>精华设置。系统提供三级精华分别为3、2、1、0。0为正常帖子。1、2、3分别代表1级精华、2级精华、3级精华。</td>
							</tr>
						</tbody>
					</table>
					
					<h4 >2.7 错误返回码说明</h4>
					<p>公共错误返回码：参考 ： <a href="index.html#public-code">公共返回码说明</a> 。 </p>
					<p>私有错误返回码。</p>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">返回码（code）</th>
								<th width="100">返回信息(msg)</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>2000</td>
								<td>会员未登录！</td>
								<td>用户必须登陆后才能看到自己发表过主题。</td>
							</tr>

						</tbody>
					</table>
					
					<h4>2.8 正确返回示例：</h4>
						<code>http://115.29.250.136:8080/homeInManchester/api/forum/mytopics/1/10</code>
						<pre>
{
    "result": [
        {
            "forumId": 5, 
            "subject": "高规格", 
            "postDate": 1387612955, 
            "author": "test", 
            "authorId": 19, 
            "userIp": "0:0:0:0:0:0:0:1", 
            "lastPost": 1387612955, 
            "views": 0, 
            "topicId": 12, 
            "replies": 0, 
            "highLight": 0, 
            "colosed": 0, 
            "displayOrder": 0, 
            "lastPoster": "test", 
            "lastPostDate": null, 
            "name": "hhelo22", 
            "message": "规范和返回", 
            "digest": 1
        }, 
        {
            "forumId": 2, 
            "subject": "野外郊游", 
            "postDate": 1387612883, 
            "author": "test", 
            "authorId": 19, 
            "userIp": "0:0:0:0:0:0:0:1", 
            "lastPost": 1387612883, 
            "views": 0, 
            "topicId": 11, 
            "replies": 0, 
            "highLight": 0, 
            "colosed": 0, 
            "displayOrder": 0, 
            "lastPoster": "test", 
            "lastPostDate": null, 
            "name": "约", 
            "message": "规范和返回", 
            "digest": 1
        }, 
        {
            "forumId": 2, 
            "subject": "去图书馆了", 
            "postDate": 1387612828, 
            "author": "test", 
            "authorId": 19, 
            "userIp": "0:0:0:0:0:0:0:1", 
            "lastPost": 1387612828, 
            "views": 0, 
            "topicId": 10, 
            "replies": 0, 
            "highLight": 0, 
            "colosed": 0, 
            "displayOrder": 3, 
            "lastPoster": "test", 
            "lastPostDate": null, 
            "name": "约", 
            "message": "规范和返回", 
            "digest": 1
        }, 
        {
            "forumId": 2, 
            "subject": "约 游泳", 
            "postDate": 1387612821, 
            "author": "test", 
            "authorId": 19, 
            "userIp": "0:0:0:0:0:0:0:1", 
            "lastPost": 1387612821, 
            "views": 0, 
            "topicId": 9, 
            "replies": 0, 
            "highLight": 0, 
            "colosed": 0, 
            "displayOrder": 0, 
            "lastPoster": "test", 
            "lastPostDate": null, 
            "name": "约", 
            "message": "规范和返回", 
            "digest": 1
        }, 
        {
            "forumId": 2, 
            "subject": "约 “去图书馆”", 
            "postDate": 1387612801, 
            "author": "test", 
            "authorId": 19, 
            "userIp": "0:0:0:0:0:0:0:1", 
            "lastPost": 1387612801, 
            "views": 0, 
            "topicId": 8, 
            "replies": 0, 
            "highLight": 0, 
            "colosed": 0, 
            "displayOrder": 0, 
            "lastPoster": "test", 
            "lastPostDate": null, 
            "name": "约", 
            "message": "规范和返回", 
            "digest": 0
        }, 
        {
            "forumId": 5, 
            "subject": "随碟附送", 
            "postDate": 1387612508, 
            "author": "test", 
            "authorId": 19, 
            "userIp": "0:0:0:0:0:0:0:1", 
            "lastPost": 1387612508, 
            "views": 0, 
            "topicId": 7, 
            "replies": 0, 
            "highLight": 0, 
            "colosed": 0, 
            "displayOrder": 1, 
            "lastPoster": "test", 
            "lastPostDate": null, 
            "name": "hhelo22", 
            "message": "规范和返回", 
            "digest": 0
        }, 
        {
            "forumId": 6, 
            "subject": "随碟附送", 
            "postDate": 1387612403, 
            "author": "test", 
            "authorId": 19, 
            "userIp": "0:0:0:0:0:0:0:1", 
            "lastPost": 1387612403, 
            "views": 0, 
            "topicId": 6, 
            "replies": 0, 
            "highLight": 0, 
            "colosed": 0, 
            "displayOrder": 0, 
            "lastPoster": "test", 
            "lastPostDate": null, 
            "name": "iiui", 
            "message": "规范和返回", 
            "digest": 0
        }, 
        {
            "forumId": 5, 
            "subject": "sdss", 
            "postDate": 1387612391, 
            "author": "test", 
            "authorId": 19, 
            "userIp": "0:0:0:0:0:0:0:1", 
            "lastPost": 1387612391, 
            "views": 0, 
            "topicId": 5, 
            "replies": 0, 
            "highLight": 0, 
            "colosed": 0, 
            "displayOrder": 0, 
            "lastPoster": "test", 
            "lastPostDate": null, 
            "name": "hhelo22", 
            "message": "山东省的方法", 
            "digest": 0
        }
    ], 
    "numPerPage": 8, 
    "pageNum": 1, 
    "totalPage": 1, 
    "totalCount": 8
}
						</pre>
					
					
					
						
					<h4>2.9 错误返回示例</h4>
					
					<code>http://localhost:8080/homeInManchester/api/forum/mytopics</code>
					<pre>
{
    "msg": "Required int parameter 'type' is not present", 
    "object": null, 
    "code": "1001"
}
					</pre>

				</section>
				
				<section id="myReply">
					<div class="page-header">
						<h1>获取用户回复过的帖子API</h1>
					</div>
					<h3>1 功能说明</h3>
					<p>获取当前用户回复过的帖子列表。</p>
					
					<br></br>
					<h3>2 接口调用说明</h3>
					<h4>2.1 URL</h4>
					<p>正式环境：</p>
					<p>1）默认请求方式：<code>http://[域名]/api/forum/myposts</code></p>
					<p>2）设置请求页码数：<code>http://[域名]/api/forum/myposts/{pageNum}</code></p>
					<p>3）设置请求页码数，设置每页多少条：<code>http://[域名]/api/forum/myposts/{pageNum}/{numPerPage}</code></p>
					
					<p>测试环境：将[域名]替换为：115.29.250.136:8080/homeInManchester</p>
					<h4>2.2  返回格式</h4>
					<p>json</p>
					<h4>2.3 http请求方式</h4>
					<p>GET</p>
					<h4>2.4 参数说明</h4>
					<p>(1) 公共参数 。详情可以参考 <a href="index.html#public_args">公共参数说明</a></p>
					<p>(2) 私有参数。暂无。</p>
					
					<h4>2.5 请求示例</h4>
					<p>第一种：默认分页方式（服务器提供默认的当前页码和一页多少条数据，默认第1页，每页8条）</p>
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/myposts</code></p>
					<p>第二种：只提供第几页（默认一页8条仍由服务器指定）</p>
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/myposts/2</code></p>
					<p>第三种：指定分页，自定义一页显示条数.（显示第2页，每页显示20条）</p>
					<p><code>http://115.29.250.136:8080/homeInManchester/api/forum/myposts/2/20</code></p>
					
					<h4>2.6 返回参数说明</h4>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>numPerPage</td>
								<td>Integer</td>
								<td>每页显示条数。</td>
							</tr>
							<tr>
								<td>pageNum</td>
								<td>Integer</td>
								<td>当前第几页。</td>
							</tr>
							<tr>
								<td>totalCount</td>
								<td>Integer</td>
								<td>总的主题数。</td>
							</tr>
							<tr>
								<td>totalPage</td>
								<td>Integer</td>
								<td>总页数。</td>
							</tr>
							<tr>
								<td>result</td>
								<td>Object[]</td>
								<td>主题列表集合，具体返回参数说明参考下面<a href="#result">《result的具体返回参数说明》</a></td>
							</tr>
						</tbody>
					</table>
					<p id="result"><strong>result的具体返回参数说明</strong></p>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>anonymous</td>
								<td>Integer</td>
								<td>是否匿名发表。1标识匿名发表，0标识非匿名。</td>
							</tr>
							<tr>
								<td>forumId</td>
								<td>Integer</td>
								<td>所属论坛版块ID</td>
							</tr>
							<tr>
								<td>subject</td>
								<td>String</td>
								<td>标题。一般属于楼主标题，也就是主题帖，会有标题，其他回复贴均没有标题。</td>
							</tr>
							<tr>
								<td>postDate</td>
								<td>Long</td>
								<td>发表日期。返回值为时间秒数。</td>
							</tr>
							<tr>
								<td>author</td>
								<td>String</td>
								<td>作者用户名。如果是匿名发表的话，就直接显示”匿名“</td>
							</tr>
							<tr>
								<td>authorId</td>
								<td>Integer</td>
								<td>用户ID。如果是匿名发表，则为0</td>
							</tr>
							<tr>
								<td>topicId</td>
								<td>Long</td>
								<td>主题ID。</td>
							</tr>
							<tr>
								<td>postId</td>
								<td>Long</td>
								<td>回帖ID</td>
							</tr>
							<tr>
								<td>postIp</td>
								<td>String</td>
								<td>回帖客户端ip地址</td>
							</tr>
							<tr>
								<td>invisible</td>
								<td>Integer</td>
								<td>不可见。默认为0（可见）</td>
							</tr>
							<tr>
								<td>message</td>
								<td>String</td>
								<td>回复内容。</td>
							</tr>
							<tr>
								<td>first</td>
								<td>Integer</td>
								<td>是否楼主（主题帖），1为主题帖，0为普通回帖</td>
							</tr>
						</tbody>
					</table>
					
					<h4 >2.7 错误返回码说明</h4>
					<p>公共错误返回码：参考 ： <a href="index.html#public-code">公共返回码说明</a> 。 </p>
					<p>私有错误返回码。</p>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">返回码（code）</th>
								<th width="100">返回信息(msg)</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>2000</td>
								<td>会员未登录！</td>
								<td>用户必须登陆后才能看到自己回复过的主题。</td>
							</tr>

						</tbody>
					</table>
					
					<h4>2.8 正确返回示例：</h4>
						<code>http://115.29.250.136:8080/homeInManchester/api/forum/myposts/1/10</code>
						<pre>
{
    "result": [
        {
            "anonymous": 0, 
            "forumId": 2, 
            "subject": null, 
            "postDate": 1387854251, 
            "author": "hsmart", 
            "authorId": 21, 
            "topicId": 9, 
            "postId": 10, 
            "postIp": "0:0:0:0:0:0:0:1", 
            "invisible": 0, 
            "message": "同去同去", 
            "first": 0
        }
    ], 
    "numPerPage": 8, 
    "pageNum": 1, 
    "totalPage": 1, 
    "totalCount": 1
}
						</pre>
					
					
					
						
					<h4>2.9 错误返回示例</h4>
					
					<code>http://localhost:8080/homeInManchester/api/forum/myposts</code>
					<pre>
{
    "msg": "Required int parameter 'type' is not present", 
    "object": null, 
    "code": "1001"
}
					</pre>

				</section>
				
				<section id="cities">
					<div class="page-header">
						<h1>获取全部城市列表API</h1>
					</div>
					
					<h3>1 功能说明</h3>
					<p>获取全部的城市。</p>
					
					<br></br>
					<h3>2 接口调用说明</h3>
					<h4>2.1 URL</h4>
					<p>正式环境：http://[域名]/api/cities</p>
					<p>测试环境：http://115.29.250.136:8080/homeInManchester/api/cities</p>
					<h4>2.2  返回格式</h4>
					<p>json</p>
					<h4>2.3 http请求方式</h4>
					<p>GET</p>
					<h4>2.4 参数说明</h4>
					<p>(1) 公共参数 。详情可以参考 <a href="index.html#public_args">公共参数说明</a></p>
					<p>(2) 私有参数。无。</p>
					<h4>2.5 请求示例</h4>
					<code>http://115.29.250.136:8080/homeInManchester/api/cities</code>
					
					<h4>2.6 返回参数说明</h4>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>cityId</td>
								<td>Integer</td>
								<td>城市唯一标识。</td>
							</tr>
							<tr>
								<td>cityName</td>
								<td>String</td>
								<td>城市名称</td>
							</tr>
							<tr>
								<td>provinceId</td>
								<td>Integer</td>
								<td>所属省份唯一标识。</td>
							</tr>
							<tr>
								<td>provinceName</td>
								<td>String</td>
								<td>省份名称</td>
							</tr>
							<tr>
								<td>zipCode</td>
								<td>String</td>
								<td>邮编</td>
							</tr>
							<tr>
								<td>members</td>
								<td>Integer</td>
								<td>会员数</td>
							</tr>
						</tbody>
					</table>
					
					<h4 >2.7 错误返回码说明</h4>
					<p>公共错误返回码：参考 ： <a href="index.html#public-code">公共返回码说明</a> 。 </p>
					<p>私有错误返回码：暂无。</p>
					
					<h4>2.8 正确返回示例：</h4>
						
						<pre>
[
    {
        "cityId": 1, 
        "provinceId": 1, 
        "zipCode": "100000", 
        "provinceName": "北京市", 
        "cityName": "北京市", 
        "members": 0
    }, 
    {
        "cityId": 2, 
        "provinceId": 2, 
        "zipCode": "100000", 
        "provinceName": "天津市", 
        "cityName": "天津市", 
        "members": 0
    }, 
    {
        "cityId": 3, 
        "provinceId": 3, 
        "zipCode": "050000", 
        "provinceName": "河北省", 
        "cityName": "石家庄市", 
        "members": 0
    }, 
    {
        "cityId": 4, 
        "provinceId": 3, 
        "zipCode": "063000", 
        "provinceName": "河北省", 
        "cityName": "唐山市", 
        "members": 0
    }, 
    {
        "cityId": 5, 
        "provinceId": 3, 
        "zipCode": "066000", 
        "provinceName": "河北省", 
        "cityName": "秦皇岛市", 
        "members": 0
    }, 
    {
        "cityId": 6, 
        "provinceId": 3, 
        "zipCode": "056000", 
        "provinceName": "河北省", 
        "cityName": "邯郸市", 
        "members": 0
    }, 
    {
        "cityId": 7, 
        "provinceId": 3, 
        "zipCode": "054000", 
        "provinceName": "河北省", 
        "cityName": "邢台市", 
        "members": 0
    }, 
    {
        "cityId": 8, 
        "provinceId": 3, 
        "zipCode": "071000", 
        "provinceName": "河北省", 
        "cityName": "保定市", 
        "members": 0
    }, 
    {
        "cityId": 9, 
        "provinceId": 3, 
        "zipCode": "075000", 
        "provinceName": "河北省", 
        "cityName": "张家口市", 
        "members": 0
    }, 
    {
        "cityId": 10, 
        "provinceId": 3, 
        "zipCode": "067000", 
        "provinceName": "河北省", 
        "cityName": "承德市", 
        "members": 0
    }, 
    ....
]

</pre>
					
					
				</section>
				
				<section id="hotCities">
					<div class="page-header">
						<h1>获取热门城市列表API</h1>
					</div>
					
					<h3>1 功能说明</h3>
					<p>获取全部热门的城市，目前规则为会员数大于10，均为热门城市。</p>
					
					<br></br>
					<h3>2 接口调用说明</h3>
					<h4>2.1 URL</h4>
					<p>正式环境：http://[域名]/api/hotCities</p>
					<p>测试环境：http://115.29.250.136:8080/homeInManchester/api/hotCities</p>
					<h4>2.2  返回格式</h4>
					<p>json</p>
					<h4>2.3 http请求方式</h4>
					<p>GET</p>
					<h4>2.4 参数说明</h4>
					<p>(1) 公共参数 。详情可以参考 <a href="index.html#public_args">公共参数说明</a></p>
					<p>(2) 私有参数。无。</p>
					<h4>2.5 请求示例</h4>
					<code>http://115.29.250.136:8080/homeInManchester/api/hotCities</code>
					
					<h4>2.6 返回参数说明</h4>
					<table class="table table-bordered">
						<thead>
							<tr>
								<th width="120">参数名称</th>
								<th width="100">类型</th>
								<th>含义说明</th>
							</tr>
						</thead>
						<tbody>
							<tr>
								<td>cityId</td>
								<td>Integer</td>
								<td>城市唯一标识。</td>
							</tr>
							<tr>
								<td>cityName</td>
								<td>String</td>
								<td>城市名称</td>
							</tr>
							<tr>
								<td>provinceId</td>
								<td>Integer</td>
								<td>所属省份唯一标识。</td>
							</tr>
							<tr>
								<td>provinceName</td>
								<td>String</td>
								<td>省份名称</td>
							</tr>
							<tr>
								<td>zipCode</td>
								<td>String</td>
								<td>邮编</td>
							</tr>
							<tr>
								<td>members</td>
								<td>Integer</td>
								<td>会员数</td>
							</tr>
						</tbody>
					</table>
					
					<h4 >2.7 错误返回码说明</h4>
					<p>公共错误返回码：参考 ： <a href="index.html#public-code">公共返回码说明</a> 。 </p>
					<p>私有错误返回码：暂无。</p>
					
					<h4>2.8 正确返回示例：</h4>
						
						<pre>
[
    {
        "cityId": 1, 
        "provinceId": 1, 
        "zipCode": "100000", 
        "provinceName": "北京市", 
        "cityName": "北京市", 
        "members": 0
    }, 
    {
        "cityId": 2, 
        "provinceId": 2, 
        "zipCode": "100000", 
        "provinceName": "天津市", 
        "cityName": "天津市", 
        "members": 0
    }, 
    {
        "cityId": 3, 
        "provinceId": 3, 
        "zipCode": "050000", 
        "provinceName": "河北省", 
        "cityName": "石家庄市", 
        "members": 0
    }, 
    {
        "cityId": 4, 
        "provinceId": 3, 
        "zipCode": "063000", 
        "provinceName": "河北省", 
        "cityName": "唐山市", 
        "members": 0
    }, 
    {
        "cityId": 5, 
        "provinceId": 3, 
        "zipCode": "066000", 
        "provinceName": "河北省", 
        "cityName": "秦皇岛市", 
        "members": 0
    }, 
    {
        "cityId": 6, 
        "provinceId": 3, 
        "zipCode": "056000", 
        "provinceName": "河北省", 
        "cityName": "邯郸市", 
        "members": 0
    }, 
    ....
]

</pre>
					
					
				</section>
				
				<section id="cityMembers">
					<div class="page-header">
						<h1>获取同城会员列表API</h1>
					</div>
					
					<h3>1 功能说明</h3>
					<p>获取会员列表。</p>
					
					<br></br>
					<h3>2 接口调用说明</h3>
					<h4>2.1 URL</h4>
					<p>正式环境：http://[域名]/api/cityMembers</p>
					<p>测试环境：http://115.29.250.136:8080/homeInManchester/api/cityMembers</p>
					<h4>2.2  返回格式</h4>
					<p>json</p>
					<h4>2.3 http请求方式</h4>
					<p>GET</p>
					<h4>2.4 参数说明</h4>
					<p>(1) 公共参数 。详情可以参考 <a href="index.html#public_args">公共参数说明</a></p>
					<p>(2) 私有参数。无。</p>
					<h4>2.5 请求示例</h4>
					<code>http://115.29.250.136:8080/homeInManchester/api/cityMembers</code>
					
					<h4>2.6 返回参数说明</h4>
					<p>返回参数为符合要求的用户列表，具体参数说明可以参考：<a href="member.html#user-info">用户基本参数</a>。</p>
					
					<h4 >2.7 错误返回码说明</h4>
					<p>公共错误返回码：参考 ： <a href="index.html#public-code">公共返回码说明</a> 。 </p>
					<p>私有错误返回码：暂无。</p>
					
					

</pre>
					
					
				</section>
				
				<section id="cityTopics">
					<div class="page-header">
						<h1>获取同城帖子列表API</h1>
					</div>
					
					<h3>1 功能说明</h3>
					<p>获取帖子（论坛主题）列表。</p>
					
					<br></br>
					<h3>2 接口调用说明</h3>
					<h4>2.1 URL</h4>
					<p>正式环境：http://[域名]/api/cityTopics</p>
					<p>测试环境：http://115.29.250.136:8080/homeInManchester/api/cityTopics</p>
					<h4>2.2  返回格式</h4>
					<p>json</p>
					<h4>2.3 http请求方式</h4>
					<p>GET</p>
					<h4>2.4 参数说明</h4>
					<p>(1) 公共参数 。详情可以参考 <a href="index.html#public_args">公共参数说明</a></p>
					<p>(2) 私有参数。无。</p>
					<h4>2.5 请求示例</h4>
					<code>http://115.29.250.136:8080/homeInManchester/api/cityTopics</code>
					
					<h4>2.6 返回参数说明</h4>
					<p>返回参数为符合要求的用户列表，具体参数说明可以参考：<a href="forum.html#topics">论坛主题参数</a>。</p>
					
					<h4 >2.7 错误返回码说明</h4>
					<p>公共错误返回码：参考 ： <a href="index.html#public-code">公共返回码说明</a> 。 </p>
					<p>私有错误返回码：暂无。</p>
					
					

</pre>
					
					
				</section>
			</div>
		</div>

	</div>



	<!-- Footer
    ================================================== -->
	<footer class="footer">
		<div class="container">
			<p>
				Designed and built with all the love in the world by <a
					href="http://www.hcrazy.com" target="_blank">@hsmart</a>
			</p>
			<ul class="footer-links">
				<li><a href="http://www.hcrazy.com">Blog</a></li>
				<li class="muted">&middot;</li>
				<li><a href="http://www.hcrazy.com">Issues</a></li>
				<li class="muted">&middot;</li>
				<li><a href="http://www.hcrazy.com">Changelog</a></li>
			</ul>
		</div>
	</footer>



	<!-- Le javascript
    ================================================== -->
	<!-- Placed at the end of the document so the pages load faster -->
	<script src="assets/js/jquery.js"></script>
	<script src="assets/js/bootstrap-transition.js"></script>
	<script src="assets/js/bootstrap-alert.js"></script>
	<script src="assets/js/bootstrap-modal.js"></script>
	<script src="assets/js/bootstrap-dropdown.js"></script>
	<script src="assets/js/bootstrap-scrollspy.js"></script>
	<script src="assets/js/bootstrap-tab.js"></script>
	<script src="assets/js/bootstrap-tooltip.js"></script>
	<script src="assets/js/bootstrap-popover.js"></script>
	<script src="assets/js/bootstrap-button.js"></script>
	<script src="assets/js/bootstrap-collapse.js"></script>
	<script src="assets/js/bootstrap-carousel.js"></script>
	<script src="assets/js/bootstrap-typeahead.js"></script>
	<script src="assets/js/bootstrap-affix.js"></script>

	<script src="assets/js/holder/holder.js"></script>
	<script src="assets/js/google-code-prettify/prettify.js"></script>

	<script src="assets/js/application.js"></script>



</body>
</html>
